Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 4 - Unicode Converter Reference / Unicode Converter Structures and Other Types

/

UnicodeMapping

A Unicode mapping structure contains a complete text encoding specification for a Unicode encoding, a complete non-Unicode text encoding specification giving the encoding for the text to be converted to or from Unicode, and the version of the mapping table to be used for conversion. You use a structure of this type to specify the text encodings to and from which the text string is to be converted. A Unicode mapping structure is defined by the UnicodeMapping data type.

struct UnicodeMapping {
   TextEncoding   unicodeEncoding;
   TextEncoding   otherEncoding;
   UnicodeMapVersion mappingVersion;
};
typedef struct UnicodeMapping UnicodeMapping
typedef UnicodeMapping *UnicodeMappingPtr;

Field Description

unicodeEncoding

A Unicode text encoding specification of type TextEncoding. See "Text Encoding Base" (page 31).

otherEncoding

A text encoding specification for the text to be converted to or from Unicode.

mappingVersion

The version of the Unicode mapping table to be used.

Many Unicode Converter functions take a pointer to a Unicode mapping structure as a parameter. For functions that do not modify the Unicode mapping contents, the Unicode Converter provides a constant pointer to a Unicode mapping structure defined by the ConstUnicodeMappingPtr data type.

typedef const UnicodeMapping *ConstUnicodeMappingPtr;